package cn.com.blueInfo.bpm.template.service;

import cn.com.blueInfo.bpm.template.request.InstanceDTO;
import cn.com.blueInfo.bpm.template.response.InstanceVO;
import cn.com.blueInfo.utils.result.ResultInfo;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;

import java.util.List;

/**
* 流程运行时实例 业务服务类
* @author suxch
* @since 2025-08-24 01:41:15
*/
public interface InstanceService {

    /**
    * 新增流程运行时实例
    * @param instanceDTO 流程运行时实例参数
    */
    ResultInfo<Integer> addInstance(InstanceDTO instanceDTO);

    /**
     * 批量新增流程运行时实例
     * @param instanceDTOList 流程运行时实例参数列表
     */
    ResultInfo<Integer> batchAddInstance(List<InstanceDTO> instanceDTOList);

    /**
    * 删除流程运行时实例
    * @param instanceId 流程运行时实例ID
    */
    ResultInfo<Integer> removeInstance(Long instanceId);

    /**
     * 批量删除流程运行时实例
     * @param instanceIdList 流程运行时实例ID列表
     */
    ResultInfo<Integer> batchRemoveInstance(List<Long> instanceIdList);

    /**
    * 更新部分流程运行时实例
    * @param instanceUpdatePartialDTO 流程运行时实例参数
    */
    ResultInfo<Integer> modifyInstancePartial(InstanceDTO.UpdatePartialDTO instanceUpdatePartialDTO);

    /**
    * 更新全部流程运行时实例
    * @param instanceDTO 流程运行时实例参数
    */
    ResultInfo<Integer> modifyInstance(InstanceDTO instanceDTO);

    /**
    * 查询一条流程运行时实例
    * @param instanceId 流程运行时实例ID
    */
    ResultInfo<InstanceVO> queryInstanceById(Long instanceId);

    /**
    * 分页查询流程运行时实例
    * @param instanceQueryDTO 流程运行时实例参数
    */
    ResultInfo<Page<InstanceVO>> queryInstancePage(InstanceDTO.QueryDTO instanceQueryDTO);

    /**
     * 根据条件查询 流程运行时实例 数量
     * @param instanceQueryDTO 流程运行时实例参数
     */
    ResultInfo<Long> queryInstanceCount(InstanceDTO.QueryDTO instanceQueryDTO);

    /**
     * 根据条件查询 流程运行时实例
     * @param instanceQueryDTO 流程运行时实例参数
     */
    ResultInfo<List<InstanceVO>> queryInstanceList(InstanceDTO.QueryDTO instanceQueryDTO);

}
